home *** CD-ROM | disk | FTP | other *** search
/ Gamers Delight 2 / Gamers Delight 2.iso / Aminet / game / board / SmokeEmPoker13.lha / Smoke'emPoker / Smoke'emPoker.doc < prev    next >
Text File  |  1994-11-22  |  30KB  |  882 lines

  1. ===== Quick Start! =====
  2.  
  3. Smoke'em Poker is a freeware game of five-card draw
  4. poker. You play against 5 other players simulated
  5. by the computer.
  6.  
  7. Requires Workbench 2.04 or later, with an overscan
  8. preferences setting of at least 704x240.
  9. May be slow on 68000-based Amigas (turn the sound
  10. off to speed it up). To get synthesized speech, you
  11. need the AmigaDOS speech software from WB 2.04 or
  12. earlier releases.
  13.  
  14. You can change the game settings at the start of
  15. each game.
  16.  
  17. Each hand proceeds as follows:
  18. - ante and dealing
  19. - opening bets (no minimum hand to open)
  20. - discarding cards (1 discard of up to 3 cards)
  21. - closing bets
  22. - the showdown (where you win, lose, or tie)
  23.  
  24. All standard poker hands are allowed, including
  25. low-ace straights (A-2-3-4-5). Check-raising
  26. (sandbagging) can be allowed or disallowed. If a
  27. computer player runs out of money, they're out of
  28. the game. If you run out of money, you can end the
  29. game or let the other players continue.
  30.  
  31. For more details, see the other topics in this
  32. documentation.
  33.  
  34. For information on what's new in this version,
  35. see "Version History" near the end of this
  36. documentation.
  37.  
  38. Just Deal It!
  39.  
  40.  
  41. ===== Introduction =====
  42.  
  43. Welcome to Smoke'em Poker. Ante up and deal it, Tex!
  44.  
  45. The game is five-card draw (for rules, see "About
  46. Five-Card Draw"). You play against five other
  47. simulated players who would like nothing better than
  48. to "smoke" you on a big pot.
  49.  
  50. (Yes, this is real multi-player poker, not another
  51. lame "video poker" game. The best thing about poker
  52. is matching wits with conniving opponents, not
  53. playing a glorified slot machine. So there.)
  54.  
  55. Smoke'em Poker uses a standard Amiga user interface,
  56. although the graphics are spartan (for now).
  57. If you've played real poker before, you should
  58. have no problem playing Smoke'em Poker.
  59.  
  60.  
  61. ===== System Requirements =====
  62.  
  63. Smoke'em Poker requires an Amiga with the following:
  64. - Workbench 2.04 or later (so upgrade, already!)
  65. - probably at least 1 meg of memory, but I'm not sure
  66.  
  67. Smoke'em Poker uses a custom overscan screen of
  68. 704x240. Your Workbench preferences for overscan
  69. should be set to at least 704x240 so that the
  70. Smoke'em Poker screen can open normally. If your
  71. Workbench isn't that big, you'll only be able to
  72. see part of the Smoke'em Poker screen at once and
  73. you'll have to put up with that annoying "auto-
  74. scroll" effect.
  75. (Sorry about this - I assumed that one could force
  76. open an overscan screen, but apparently not.
  77. Unfortunately, it's a major pain to rearrange every-
  78. thing to fit on a standard (640x200) screen. Sigh...)
  79.  
  80. To get synthesized speech, you must have the
  81. AmigaDOS speech synthesis software. This was part of
  82. the system software in WB 2.0x, but Commodore (in
  83. their finite wisdom) removed it from later system
  84. releases. If you have WB 2.1 or later, you just need
  85. to get your hands on the 2.04 speech software
  86. (narrator.device, "Say", etc.). How you get it is
  87. your business...  ;^)
  88. Smoke'em Poker does speech by sending arguments to
  89. the "Say" program, which it expects to find in the
  90. Utilities drawer of your boot volume (sys:). So,
  91. if your "say" program is elsewhere, move or copy
  92. it to "sys:utilities".
  93.  
  94. While Smoke'em Poker should run on any model of
  95. Amiga, it will probably be sluggish on slower
  96. (68000-based) Amigas. To speed things up, turn the
  97. sound off.
  98.  
  99.  
  100. ===== About Five-Card Draw =====
  101.  
  102. Poker comes in hundreds of different flavours, but
  103. five-card draw is probably the best known and
  104. simplest form. Here's how it goes:
  105.  
  106. After paying an initial ante, each player is dealt
  107. five cards down (visible only to that player).
  108.  
  109. After the cards are dealt, the opening round of
  110. betting starts with the player to the left of the
  111. dealer. Betting continues clockwise around the table
  112. until all players have matched the highest bet or
  113. folded out of the hand. There is NO minimum hand
  114. required to open the betting. If no bets are made
  115. (that is, everyone checks), then the hand continues
  116. normally - everyone gets what amounts to a free
  117. discard.
  118.  
  119. All players who pay the opening bet can then discard
  120. UP TO THREE cards from their hands. These cards are
  121. replaced by the same number of new cards from the
  122. deck.
  123.  
  124. A closing round of betting follows, starting with
  125. the player who last raised in the opening round. All
  126. players who pay the final bet then reveal their
  127. hands in the "showdown". The player with the best
  128. hand wins the "pot" (the accumulated money bet
  129. during the hand). In case of a tie (which is rare),
  130. the winners split the pot.
  131.  
  132. For more information on using Smoke'em Poker's
  133. interface to play a round of five-card draw, see
  134. "Playing A Round".
  135.  
  136.  
  137. ===== What Beats What? =====
  138.  
  139. For those of you who keep forgetting, here's the
  140. order of poker hands (from worst to best):
  141.  
  142. Runt (nothing, nada, e.g. 2-4-7-J-K)
  143. Pair (e.g. 2-2-7-J-K)
  144. Two Pair (e.g. 2-2-7-7-K)
  145. Three of a Kind (e.g. 2-2-2-J-K)
  146. Straight (e.g. 2-3-4-5-6, but different suits)
  147. Flush (e.g. five hearts, but not consecutive)
  148. Full House (e.g. 2-2-2-7-7)
  149. Four of a Kind (e.g. 2-2-2-2-7)
  150. Straight Flush (e.g. 2-3-4-5-6, all of same suit)
  151. Royal Flush (10-J-Q-K-A, all of same suit)
  152.  
  153. Smoke'em Poker automatically displays which of the
  154. above hands you have. It's up to YOU to make money
  155. with it.
  156.  
  157. (In some cases, Smoke'em Poker may tell you that
  158. you have an inside straight, outside straight,
  159. "baby" flush, or "baby" straight flush. For more
  160. information on these special hands, see "Four-card
  161. Hands".)
  162.  
  163.  
  164. ===== House Rules =====
  165.  
  166. Every poker gathering decides on a few "house
  167. rules". Here are the house rules for Smoke'em Poker:
  168.  
  169. Low-Ace Straights:
  170. Normally, aces are high (valued above kings). The
  171. only exception to this is a low-ace straight
  172. (A-2-3-4-5), where the ace is the "one" card.
  173. If you get an low-ace straight, Smoke'em Poker
  174. automatically re-sorts your hand to put the ace
  175. before the 2.
  176. Note that an ace can only be high OR low in a given
  177. hand. You cannot create a "wrap-around" straight
  178. using an ace (for example, Q-K-A-2-3).
  179.  
  180. Splitting Pots:
  181. Once in a great while, two or more players will tie
  182. at the showdown. For example, two players may have
  183. the same two pair.
  184. The "kickers" (the remaining card(s) in their hands)
  185. are used to determine the winning hand. If the
  186. kickers are also equal, the players divide the money
  187. in the pot equally.
  188. In case of tied flushes (for example, two players
  189. with king-high flushes), the suit is NOT used to
  190. break the tie - suits have no inherent value.
  191.  
  192. Check-Raising:
  193. This house rule is configurable - see "Setting
  194. Preferences".
  195.  
  196.  
  197. ===== Setting Preferences =====
  198.  
  199. When you start a new game of poker, the
  200. preferences window appears, and Smoke'em Poker
  201. automatically loads any saved game settings from
  202. its icon. You can then set the following:
  203.  
  204. Your Name:
  205. Enter your name (up to 12 characters).
  206. If you don't enter a name, you'll be called
  207. "Stranger". Defaults to blank.
  208.  
  209. Opponents:
  210. Opens the opponents window in which you set your
  211. opponents names, skill levels, and so on.
  212. For more information on this window, see "Choosing
  213. Opponents".
  214.  
  215. Starting Cash:
  216. The amount of money that every player starts with.
  217. Must be between $100 and $10000. Defaults to $1000.
  218.  
  219. Ante:
  220. The amount of money that each player chips in to
  221. play in each hand.
  222. Must be between $1 and $100. Defaults to $10.
  223.  
  224. Maximum Raises:
  225. The maximum number of raises (NOT including the
  226. first bet) that are allowed in each round of betting.
  227. Must be between 1 and 10. Defaults to 3.
  228.  
  229. Minimum Bet:
  230. The smallest amount that a player can raise.
  231. Must be between $5 and $50, but must be smaller than
  232. the medium bet (see below). Defaults to $10.
  233.  
  234. Medium Bet:
  235. The in-between amount that a player can raise.
  236. Must be between $10 and $100, but must be larger
  237. than the minimum bet and smaller than the
  238. maximum bet. Defaults to $25.
  239.  
  240. Maximum Bet:
  241. The largest amount that a player can raise.
  242. Must be between $15 and $200, but must be larger
  243. than the medium bet. Defaults to $50.
  244.  
  245. Allow Check-Raising (Sandbagging):
  246. To allow check-raising (also known as sandbagging)
  247. in the game, select this checkbox.
  248. Check-raising means that if player A checks, then
  249. player B raises, player A is allowed to re-raise
  250. the bet. You typically check-raise when you have a
  251. strong hand but want to see who else does too.
  252. Instead of making the first raise, you check (pass)
  253. the bet. When someone else raises, you can then
  254. raise them more.
  255. If you disallow check-raising, player A (in the
  256. example above) would not be allowed to re-raise -
  257. they would have to call instead.
  258. Defaults to on.
  259. Note: Call-raising (re-raising when you had
  260. previously called) is ALWAYS allowed.
  261.  
  262. Reveal All Hands:
  263. To show the other players' hands face-up, select this
  264. checkbox. This option is useful for figuring out how
  265. the simulated players bet. Defaults to off.
  266.  
  267. Show Skill:
  268. To show each player's skill level during the game,
  269. select this checkbox. The skill level is shown beside
  270. the player's name in short form (for example,
  271. "Dave (b)" means that Dave has a skill level of
  272. "bonehead"). Defaults to off.
  273. For more information on skill levels, see
  274. "Choosing Opponents".
  275.  
  276. Reset To Saved:
  277. Reloads saved values from Smoke'em Poker's tooltypes
  278. (stored in its icon). Useful if you've mucked around
  279. with the game settings and then decide to cancel
  280. your changes.
  281.  
  282. Reset To Defaults:
  283. Resets all values in the preferences window and the
  284. opponents window to their default values.
  285. Note: If Smoke'em Poker cannot load its game settings
  286.       from its icon, it will automatically reset all
  287.       values to their defaults.
  288.  
  289. Save & Start:
  290. Exits from the preferences window, saves your game
  291. settings, and starts the new game.
  292. Note: If Smoke'em Poker cannot save its game settings
  293.       to its icon, an error window will warn you of
  294.       this before starting the new game.
  295.  
  296. A Note About Icon Tooltypes:
  297. Smoke'em Poker saves your game settings by storing
  298. them as tooltypes in its icon (.info file).
  299. To change the game settings, I recommend that you
  300. take the easy route and use the controls in the
  301. preferences window and opponents window.
  302. However, if you choose to manipulate the tooltypes
  303. directly in Workbench (using the "Information"
  304. command), note the following:
  305. - If Smoke'em Poker doesn't find or understand a
  306.   tooltype, it uses the appropriate default value.
  307. - If a numeric tooltype (like StartingCash) contains
  308.   a value outside its legal range, Smoke'em Poker
  309.   uses the appropriate minimum or maximum value
  310.   instead.
  311.  
  312.  
  313. ===== Choosing Opponents =====
  314.  
  315. From the preferences window, you can open the
  316. opponents window to set up the computer players
  317. for the next game.
  318.  
  319. In this window, the computer players are arranged as
  320. they will appear in the game. For each player, you
  321. can set the following:
  322.  
  323. Active:
  324. To include the player in the game, select this
  325. checkbox. If you de-select it, the other controls
  326. for the player are automatically disabled.
  327. This option makes it possible for you to play
  328. a game with fewer than five opponents.
  329.  
  330. Male:
  331. Determines the sex (male or female) of the player.
  332. This helps Smoke'em Poker to supply appropriate
  333. names for unnamed players, and to set appropriate
  334. male/female voice settings.
  335. (Socially Correct Disclaimer: Having a Male/notMale
  336.  checkbox is NOT intended to be chauvinistic - it
  337.  simply saves some room in the window.)
  338.  
  339. Name:
  340. Enter the name of the computer player. If you supply
  341. a name of your own, make sure that you have set the
  342. Male checkbox to agree with the name (so that the
  343. voice matches the player's sex).
  344. If you leave the Name field blank, Smoke'em Poker
  345. will supply a random name each time you start a
  346. new game. The name will be male or female depending
  347. on the Male checkbox.
  348.  
  349. Skill:
  350. To set the skill of the computer player, click
  351. repeatedly to cycle through these skill levels:
  352. - Bonehead - Can barely distinguish good hands from
  353.              bad ones, but bets anyway (duh).
  354. -     Fair - Bets based on the value of his/her own
  355.              hand only.
  356. -     Good - Bets based on the value of his/her own
  357.              hand and the amount of betting so far
  358.              in the round.
  359. - (Random) - For each new game, this selects a random
  360.              skill level (Bonehead, Fair, or Good).
  361.              The random skill level is only revealed
  362.              if you select the Show Skill checkbox
  363.              in the preferences window.
  364. In upcoming releases of Smoke'em Poker, I hope to add
  365. higher skill levels - see "Future Enhancements".
  366.  
  367. Done:
  368. Exits the opponents window and returns to the
  369. preferences window.
  370.  
  371. Note: The settings in the opponents window are saved
  372.       automatically along with the settings in the
  373.       preferences window.
  374.  
  375.  
  376. ===== Playing A Hand =====
  377.  
  378. Paying The Ante And Dealing:
  379. To deal a new hand, click the "Deal" button. Each
  380. player will automatically pay the ante for the hand,
  381. and the cards will then be dealt by the next dealer.
  382. The dealer is outlined in pink while dealing, and
  383. the dealer's name is highlighted in pink throughout
  384. the hand.
  385. Note that, even if a player's cards are shown
  386. face-up on the screen (using the "Reveal All Hands"
  387. option), players can NEVER see each other's cards
  388. (except at the end of a hand).
  389.  
  390. Opening Bets:
  391. When the betting comes around to you, you can do
  392. one of the following:
  393. - "Check" (or pass) your bet if no one else has bet
  394.   yet. The "Check" button does not appear if
  395.   someone has made a bet before you.
  396. - "Fold" your hand to get out of the current hand
  397.   without matching the current bet. The "Fold"
  398.   button does not appear if no one has made a bet
  399.   yet.
  400. - "Call" the current bet by paying enough to match
  401.   it.
  402. - "Raise" the current bet by matching it and then
  403.   increasing it by a certain amount.
  404.   To raise, click the "Raise" button and choose
  405.   from one of the three fixed amounts in the Raise
  406.   window.
  407.   These amounts are determined by the preferences
  408.   that you set for the game - see "Setting
  409.   Preferences".
  410.   The "Raise" button does not appear if the
  411.   maximum number of raises has already been
  412.   reached, or if this would be a check-raise in a
  413.   game where you had prohibited check-raising - see
  414.   "Setting Preferences".
  415.  
  416. Discarding Cards:
  417. To drop UP TO THREE cards from your hand, click the
  418. "X"-shaped discard pointer on the unwanted cards,
  419. then click the "Discard" button. The new cards are
  420. dealt from the deck and automatically sorted into
  421. your hand.
  422. To "stand pat" (that is, to keep all of your cards),
  423. make sure that no cards are selected, then click the
  424. "Discard None" button.
  425.  
  426. Closing Bets:
  427. Betting in the closing round is done exactly like it
  428. is in the opening round, except that it starts with
  429. the player who last raised in the opening round.
  430.  
  431. The Showdown:
  432. When all players reveal their hands, the winner of
  433. the hand is outlined in gold (the colour of money)
  434. and collects the money in the pot.
  435. At this point, if a simulated player is out of
  436. money, they leave the game. If you are the last
  437. player left, you win the game. If YOU run out of
  438. money, the game ends (see "Running Out Of Money").
  439.  
  440.  
  441. ===== Four-card Hands =====
  442.  
  443. As a convenience, in the opening round of betting
  444. (before you discard), Smoke'em Poker will check your
  445. cards for the following four-card hands:
  446.  
  447. - baby straight flushes - four-card straight
  448.   flushes with no gaps
  449. - baby flushes - four-card flushes (gaps or not)
  450. - outside straights - four-card straights with no
  451.   gaps (a.k.a. two-sided straights)
  452. - inside straights - four-card straights with a
  453.   gap between two of the cards, or one-sided
  454.   straights (ace-low or ace-high)
  455.  
  456. These hands, while worth nothing in themselves, only
  457. need one card to make them into excellent hands.
  458.  
  459. Smoke'em Poker points out these promising hands for
  460. you, but only points them out BEFORE the discard
  461. (while you still have a chance to complete them).
  462.  
  463. When deciding how to label your hand BEFORE the
  464. discard, Smoke'em Poker follows these rules:
  465. - inside straights are better than runts,
  466. - outside straights are better than pairs,
  467. - baby flushes are better than outside straights,
  468. - baby straight flushes are better than baby flushes.
  469.  
  470. For example, suppose that you started with a hand of
  471. 3-4-4-5-6. Before you discarded anything, Smoke'em
  472. Poker would label your hand as an outside straight,
  473. since this is POTENTIALLY worth more than your pair.
  474. If you had this same hand AFTER the discard,
  475. however, the outside straight would no longer have a
  476. chance of becoming a real (five-card) straight, so
  477. Smoke'em Poker would label it as just a pair.
  478.  
  479.  
  480. ===== Controlling Sound =====
  481.  
  482. To turn sound on or off, click the Sound checkbox at
  483. the upper left corner of the screen (duh).
  484.  
  485. In this release, sound is implemented as synthesized
  486. speech. For example, your opponents will speak up
  487. when betting ("I call", etc.). Their voices are
  488. matched to their sex - see "Choosing Opponents".
  489.  
  490. To get speech, you must have the AmigaDOS 2.0x
  491. speech software. For more information, see "System
  492. Requirements".
  493.  
  494. Sound is another part of Smoke'em Poker that I plan
  495. to improve in an upcoming release - see "Future
  496. Enhancements".
  497.  
  498.  
  499. ===== Getting Help =====
  500.  
  501. To get help at any time during the game:
  502. - Click the Help button, or
  503. - Press the Help key (what a concept!)
  504.  
  505. This opens a help window that shows a list of topics.
  506. Click on a topic to show the corresponding help text.
  507.  
  508. To exit from the help window, click the close box
  509. at the upper left corner of the window.
  510.  
  511. Smoke'em Poker's on-line help is the same as the
  512. text file (Smoke'emPoker.doc) included with this
  513. distribution. In fact, the on-line help is generated
  514. from the text file at run-time.
  515.  
  516. Note: If Smoke'em Poker cannot find its help file
  517.       (Smoke'emPoker.doc) in the same directory as
  518.       Smoke'em Poker, it will ask you to find the
  519.       help file using a standard file requester. If
  520.       you can't find the help file, it will close the
  521.       help window and return you to the game.
  522.  
  523.  
  524. ===== Generating Stats =====
  525.  
  526. For each poker game that you play, Smoke'em Poker
  527. keeps track of various statistics that can help you
  528. analyze your play (and your opponents' play).
  529.  
  530. To examine the stats for the current game, click
  531. the Stats button. This opens a stats window that
  532. shows a list of categories. Click on a category to
  533. display the corresponding stats.
  534.  
  535. To exit from the stats window, click the close box
  536. at the upper left corner of the window.
  537.  
  538. Note that you can't look at stats in the
  539. middle of a hand. The Stats button is only
  540. available between hands.
  541.  
  542. Statistics can be very useful in computer poker,
  543. since you typically play many more hands in a
  544. given time that you would in normal poker. This
  545. can help point out weaknesses in your play (for
  546. example, discovering that you are in too many
  547. showdowns, which is a losing habit in the
  548. long run).
  549.  
  550.  
  551. ===== Running Out Of Money =====
  552.  
  553. A player can keep playing until they run out of
  554. money. More precisely, a player can play a hand if
  555. they can afford the ante. They are permitted to go
  556. into debt (showing negative cash) while betting on
  557. a hand.
  558.  
  559. When one of your simulated opponents doesn't have
  560. enough money left to ante up for the next hand, they
  561. leave the table, and their name is shown dimmed.
  562. If you bankrupt ALL of your opponents, the game
  563. ends with you as the new poker champion (woohoo!).
  564.  
  565. If YOU run out of money, you can do the following:
  566. - Start a new poker game (everyone gets a fresh
  567.   bankroll), or
  568. - Crawl into a hole and die (quit, that is), or
  569. - If there are at least two other players left, you
  570.   can let them continue the game without you (see
  571.   "Watching The Game").
  572.  
  573.  
  574. ===== Watching The Game =====
  575.  
  576. Instead of playing in every hand, you can sit out
  577. for a while and watch the other players go at it.
  578.  
  579. To watch the game, click the Watch button. The other
  580. players will continue the game without you until you
  581. interrupt them or until one of them bankrupts all of
  582. the other players.
  583.  
  584. To interrupt a game that you're watching, click the
  585. Stop Watching button. Once the players finish the
  586. current hand, you can then continue.
  587.  
  588. You can also watch a game if you lose all of your
  589. money AND there are at least two other players left.
  590. In the "losing" window that appears, click the
  591. "Let Other Players Continue" checkbox. When you
  592. exit from the window, the remaining players will
  593. continue the game as described above.
  594.  
  595. Note that you can't start watching the game in the
  596. middle of a hand. The Watch button is only
  597. available between hands.
  598.  
  599.  
  600. ===== Restarting The Game =====
  601.  
  602. To end the current poker game and start a new
  603. poker game, click the Restart button. This opens
  604. the preferences window again and lets you set
  605. your preferences for the next game. It also
  606. resets each player's cash to the starting cash
  607. amount, and resets the game statistics.
  608.  
  609. Note that you can't restart the game in the middle
  610. of a hand. The Restart button is only available
  611. between hands.
  612.  
  613.  
  614. ===== Quitting The Game =====
  615.  
  616. To quit Smoke'em Poker at any time and return to
  617. the Workbench, click the Quit button. A confirmation
  618. window will ask whether you really want to quit.
  619.  
  620.  
  621. ===== Future Enhancements =====
  622.  
  623. Here's what I'd like to add to future releases of
  624. Smoke'em Poker (in no particular order):
  625.  
  626. - An option for digitized sound for each player.
  627.   I like the idea of playing sound files from
  628.   external directories, so you could supply your
  629.   buddies' voices and make Smoke'em Poker feel more
  630.   like your own weekend poker game.
  631.  
  632. - More skill levels and selectable playing styles
  633.   (loose or conservative) for the computer players.
  634.   Also, computer players that learn about your
  635.   betting tendencies and adjust their play
  636.   accordingly.
  637.   Eventually, I'd like to open up Smoke'em Poker
  638.   to external players that play via ARexx. This
  639.   would allow you to code your own computer
  640.   players and hook them into the game. This would
  641.   make for an interesting my-player-will-smoke-
  642.   your-player "tournament".
  643.  
  644. - More poker variations, of course, starting with
  645.   the more common games like five-card stud, seven-
  646.   card stud, hold'em, high/low splits, and so on.
  647.   This would also open the door for dealer's choice.
  648.   I'm not a big fan of wild-card games, so don't
  649.   hold your breath for "pregnant threes"... ;^)
  650.  
  651. - An option for playing over a network, modem, or
  652.   direct connection. This would fill one or more of
  653.   those other spots at the table with live people
  654.   using Amigas linked to yours.
  655.  
  656. - An Odds button that shows you the odds of
  657.   improving your hand vs. the odds offered by the
  658.   pot.
  659.  
  660. - An Ask button that shows you what the various
  661.   levels of computer players would do if they had
  662.   your hand. Useful when you're just learning.
  663.  
  664. - Better graphics and animation, perhaps including
  665.   a graphic pot that grows as more money is bet,
  666.   animated dealing and discarding, player graphics
  667.   (with an option to supply your own), choice of
  668.   cardback graphics, and so on.
  669.   I can barely draw stick-men, so if you want to
  670.   do some better graphics, let me know - see
  671.   "About The Author".
  672.  
  673. - A more robust user interface, including key
  674.   shortcuts for common functions (pressing "F" to
  675.   fold, etc.), and voice control using a sound
  676.   digitizer.
  677.  
  678. - Hooks to David Braben's Frontier(tm). Just imagine
  679.   cruising the galaxy, docking your Cobra Mark III
  680.   at the nearest orbiter, and challenging those
  681.   Imperial scum to a fast-and-loose game of
  682.   Follow-the-Emperor, no limit. Hmmm. Maybe next
  683.   release...
  684.  
  685. Any other enhancements or changes that you'd like to
  686. see? Let me know - see "About The Author".
  687.  
  688.  
  689. ===== Acknowledgments =====
  690.  
  691. Here's the section where I admit who I've ripped off
  692. for ideas  ;^)
  693.  
  694. Namely:
  695.  
  696. - "Poker Pete" on my old TRS-80 Model III.
  697.   When you had beaten Pete out of all his money, he
  698.   got up, pulled out his six-gun, and plugged you.
  699.   Now THERE'S a way to end a computer game!
  700.  
  701. - "Vegas Johnny Draw Poker" by Top Score Software
  702.   on MS-DOS (boo, hiss!).
  703.   Pretty it ain't, but the keyboard interface is
  704.   simple and the play is easy to follow. Some
  705.   good betting algorithms, too.
  706.   This is the game I was looking for on the Amiga,
  707.   but the existing Amiga poker games either had
  708.   brain-dead interfaces or were just "video" poker.
  709.   Smoke'em Poker owes a lot to Vegas Johnny.
  710.  
  711. - The book "Poker According To Maverick" (from the
  712.   original TV series with James Garner). This is
  713.   the most useful how-to poker book that I've come
  714.   across. Lots of entertaining anecdotes written in
  715.   that easy-going cowpoke style, plus a practical
  716.   list of ten poker "commandments" to help you
  717.   improve your play.
  718.  
  719. - The players in my local Saturday-night game
  720.   (Gina, Paul, Rob, Karen, Lou, and Gord) who play-
  721.   tested Smoke'em Poker, and without whom it
  722.   would have taken half the time to program.  ;^D
  723.   Thanks to Rob, especially, for losing some
  724.   huge real-life pots and thereby providing me
  725.   with a name for my program ("What a smoke! What
  726.   an incredible burn!"). Sorry that I couldn't
  727.   include an animation of the famed Dance-Of-
  728.   The-Unbelievably-Smoked in this release.
  729.  
  730. - Finally, thanks to INOVAtronics for CanDo, an
  731.   easy-to-use authoring system that made it
  732.   possible for a C-hater like me to produce
  733.   Amiga programs.
  734.  
  735.  
  736. ===== Version History =====
  737.  
  738. 1.3 - November 22, 1994
  739.     - fixed nasty little bug that hung the game
  740.       when you were down to a single opponent
  741.     - fixed stats bug where restarting did not
  742.       reset # of games won or lost by each player
  743.     - added applause when you win (hey, I had to
  744.       add something other than bug fixes...)
  745.     - remembered to reset options to defaults
  746.       before releasing (unlike 1.2 - duh)
  747.     - thanks to Bruce Elrick and John Hanley for
  748.       bug reports and suggestions
  749.     - posted to CRS, Aquilonia, Aminet, and Fred Fish
  750.  
  751. 1.2 - November 13, 1994
  752.     - added selectable sex, names, and skill levels
  753.       for opponents, and selectable # of opponents
  754.     - added preference settings for check-raising
  755.       and showing skill levels of opponents
  756.     - preferences are now automatically loaded and
  757.       saved (stored as tooltypes in icon)
  758.     - changed betting status text to show total bet
  759.       AND net amount owed by player
  760.     - added text during final betting to show # of
  761.       cards drawn by opponents (in case you forget)
  762.     - changed Max.Raises setting to NOT include
  763.       first bet (for example, MaxRaises=3 means a
  764.       maximum of 1 initial bet and 3 subsequent
  765.       raises)
  766.     - changed stats so that %Won and %Lost for
  767.       each player is percentage of hands shown
  768.       instead of total hands played
  769.     - made speech asynchronous (no waiting) where
  770.       possible, made speech smarter, added phrases
  771.     - changed the help window to handle a renamed or
  772.       relocated help file, and to reject files that
  773.       are not valid help files
  774.     - updated and tested under KS/WB 3.1
  775.     - for bug reports and suggestions, thanks to
  776.       Terry Smallwood, Gina Grimshaw, Lou Spada,
  777.       Gordon Paul, and Peter van Campen
  778.     - posted to CRS and Aquilonia
  779.  
  780. 1.1 - October 8, 1994
  781.     - added Stats button for assorted statistics
  782.     - added Watch button for auto-play mode
  783.     - made computer players a bit smarter (for
  784.       example, they're now much less likely to fold
  785.       in the face of aggressive betting)
  786.     - added more phrases for speech
  787.     - increased default ante from $5 to $10
  788.     - dealer is now outlined when dealing
  789.     - names of bankrupt players are now dimmed
  790.       (instead of erased)
  791.     - in the showdown, the called player is first
  792.       to reveal their cards (used to start left
  793.       of dealer)
  794.     - fixed a bug where computer players didn't
  795.       draw to inside straights when given a free
  796.       opportunity
  797.     - fixed a bug that prevented "kickers" from being
  798.       shown in the labeling of very close hands
  799.     - changed inactive-window pointer from "busy"
  800.       pointer to "prohibit" pointer
  801.     - tested on more machines - no surprises
  802.     - for bug reports and suggestions, thanks to Lou
  803.       Spada, Gordon Paul, Lam Bui, Terry Smallwood
  804.     - posted to CRS, Aquilonia, and Aminet
  805.  
  806. 1.0 - July 30, 1994
  807.     - tested on my 3000 (WB 2.04, 6 megs)
  808.       and Lou's 2000 (WB 2.x?, 3 megs)
  809.     - posted to Canada Remote Systems (CRS-Online)
  810.  
  811.  
  812. ===== About BeerWare =====
  813.  
  814. Smoke'em Poker is BeerWare:
  815. if you like it, have a beer!
  816.  
  817. BeerWare is FREE, so keep it, play it, and make
  818. copies of it for your friends.
  819.  
  820. (A long time ago, in an interview far, far away,
  821. a games programmer remarked that he and his rivals
  822. were competing for the user's beer-money.
  823. Hence the happy concept of BeerWare - you can play
  824. this game AND still afford beer.)
  825.  
  826. While this software is freely redistributable,
  827. it is NOT public domain, meaning that:
  828. - I retain the copyright (1994 Dave O'Brien)
  829. - You shouldn't change the program and then
  830.   redistribute it yourself.
  831.   If you discover bugs or think up improvements,
  832.   let me know and I'll try to oblige you - see
  833.   "About The Author".
  834.  
  835. Distributors: don't be wankers and try to charge
  836. anything for this, except for nominal copying
  837. fees.
  838.  
  839. Fred Fish: feel free to put this on an upcoming
  840. Fish disk, and thanks for all the great software
  841. you've supplied us with for so many years.
  842.  
  843. More BeerWare coming soon (?):
  844. - Battle Grid - two players pit their knights,
  845.                 assassins, clerics, and sorcerors
  846.                 against each other on a 8x8 grid
  847. - Net Runner  - expand and conquer a computer network
  848.                 using viruses, trojan horses, and
  849.                 worms to punch through your
  850.                 opponents' I.C.E.
  851.  
  852. By the way, this documentation is also BeerWare: if
  853. you've read this far, have another beer!
  854.  
  855.  
  856. ===== About The Author =====
  857.  
  858. I'm a technical writer by trade (paid by the word -
  859. can you tell?), and I do my work on Macs and PCs,
  860. but the Amiga is still my favourite for having fun.
  861.  
  862. I've been fooling with Amigas for a long time now,
  863. but only recently tried programming them (thanks to
  864. CanDo for making this part easier).
  865.  
  866. My two other favourite things to do are playing poker
  867. and riding recumbent bikes (usually not at the same
  868. time).
  869.  
  870. If you have suggestions for Smoke'em Poker, or ideas
  871. for other thinking games that you'd like to see (but,
  872. um, not the high-speed arcade sort - remember, I use
  873. CanDo, not AMOS), send me mail at one of the
  874. following addresses:
  875.  
  876.  Canada Remote Systems: "dave obrien"
  877.          Aquilonia BBS: "Rogue Cheddar"
  878.               Internet: "dave.obrien@sybase.com"
  879.             Snail-mail: Dave O'Brien
  880.                         13 Homewood Ave.
  881.                         Kitchener, Ontario
  882.                         Canada, N2M 1X1